home *** CD-ROM | disk | FTP | other *** search
/ Nothing but GIFs AGA / Nothing But GIFs.iso / zgif04.lha / ZGif.doc < prev    next >
Text File  |  1993-07-27  |  6KB  |  142 lines
  1.  
  2.     ZGif V0.4            1993 Michael Zucchi
  3.  
  4.  16/256 colour gif viewer.
  5.  68020 & 68000 versions.  AGA = great!
  6.  
  7.  Note:
  8.       "The Graphics Interchange Format(c) is the Copyright property of
  9.       CompuServe Incorporated. GIF(sm) is a Service Mark property of
  10.       CompuServe Incorporated."
  11.  
  12.  -------------------------------------------------------------------------
  13.  
  14.  Usage:
  15.     zgif[00] file1 file2 ...
  16.  
  17.  Each picture is decompacted and converted into bitplane format on a screen
  18.  which pops up in front.  When you press either mouse button, the screen is
  19.  closed, and the next picture is loaded.
  20.  To speed up loading on a non-aga (or AGA Super-hires/DBLPAL screen) try
  21.  hitting right-amiga-n to put workbench in front.
  22.  
  23.  -------------------------------------------------------------------------
  24.  
  25.  Good bits:
  26.  
  27.  o Its fast.  (about fastgif speed - i just cant make it go any faster)
  28.      about 5 secs - to - screen for a 750x512 picture - on a1200
  29.      with no fast.  Or about 12 seconds for a 1200x800 monster.
  30.    One of the things that makes it so fast is its chunky to planar converter.
  31.    Its not a brilliant converter, but its still faster than WritePixelLine8()
  32.    by quite a bit.  Currently uses a different routine for each resolution,
  33.    which can cause problems!
  34.  o asynchronous file reading routines allow an A1200 to load GIF's off of
  35.    floppies as fast as off of a HDD! (or RAM: for that matter :)  They should
  36.    allow a FAST cpu to load as fast as the I/O can load (i.e. '040 + SCSI-II
  37.    should be real-time :)
  38.  o Its small.  About 3.5K.
  39.  o Its does 256 colour pics IN 256 COLOURS!  Unlike the latest FastGif,
  40.    it uses the full 24 bit pallete!  (AGA required guys!)
  41.  o Memory used is only the memory required for the program, plus 16K for
  42.    the LZW decoder, and 15 K for 3, 5K read buffers plus the screen of course!
  43.  o will now (hopefully guru free) load 16 colour GIF's on any Amiga
  44.  
  45.  -------------------------------------------------------------------------
  46.  
  47.  Limitations: (bad bits)
  48.  
  49.  o Only 16 'grey' mode is supported for non-aga machines.  This normally
  50.    doesn't prove troublesome unless you have ECS and try to display a
  51.    >800 across picture.  The displaymode code will attempt to use
  52.    superhires, which only allows 4 colour screens (in ECS) - resulting in
  53.    nothing being displayed (4 colour code not present yet)
  54.    It sometimes tries to display 16 grey's into this 2 bitplane screen->crash.
  55.  o Currently only handles non-interleaved, 256 and 16 colour GIFs (most are
  56.    these)
  57.  o No real options.  It shows GIFs and thats all.
  58.  
  59.  -------------------------------------------------------------------------
  60.  
  61.  Version 0.4 update
  62.  
  63.  WOW!  Added async file reading routines.  Bumped up the code about 1K
  64.  but ... On a 1200 it will load a GIF off of a floppy about the same speed
  65.  as off of HDD!  _Amiga_ forever! :)  It loads GIFs as fast (?) as IFF's
  66.  normally load! (off of floppy)
  67.  As a bonus, memory requirements are _dramatically_ reduced, now only 15K
  68.  is needed for a read buffer (used to be entire file)
  69.  
  70.  Version 0.3 update
  71.  
  72.  Managed to bash out a 68000 version of the program, it is nearly as fast
  73.  as the '020 version on my 1200.  I'd like to know which is faster with
  74.  FAST mem?  The '020 version is a few hundred bytes shorter anyway.
  75.  Two versions are provided, ZGif and ZGif00.
  76.  
  77.  Version 0.2 update
  78.  
  79.  It will now load 16 colour gif's without crashing (hopefully).  0.1 could
  80.  actually load 16 colour gifs!  But they often crashed the program - some
  81.  GIF encoders don't seem to include an ending code before the data runs
  82.  out ...
  83.  Also added the CompuServe Inc notice.
  84.  
  85.  Version 0.1 update
  86.  
  87.  Now added support for non aga Amigas in form of 16 shade greyscale output.
  88.  See end of doc for history information.
  89.  I've also decided to adopt CBM's version scheme.  Numbers will be 0.x
  90.  with x going from 0 to xxxx one at a time.  I will get to 1.0 when an
  91.  initially completed version is made - and i'll relase it to the world!
  92.  
  93.  -------------------------------------------------------------------------
  94.  
  95.  Plans: (no order)
  96.  
  97.  o Add more non-aga support.
  98.  o Add some options -
  99.      force screenmode/resolution
  100.      slideshow stuff -
  101.          timeout for a picture
  102.          double-buffer loading (load one while displaying one)
  103.      anything else ???
  104.  o Possibly add graphics.library calls to convert chunky->planar.
  105.    For those lucky bastards with non-standard graphics.
  106.    Not in the standard version.  I gave WritePixelLine8() a go, it
  107.    makes the entire program run about 2x slower :(
  108.  o Add more display database manipulation.  As it stands, i assume
  109.    'INTERLACED' would be used (with the 'default monitor') for
  110.    pictures bigger than 300 high.
  111.    This is not the correct way to use the display database.
  112.    V39 has a 'GetBestMode()' call, but not many people have 3.0! :(
  113.  o maybe HAM or 16 colour preview mode for 256 colour pics on non-AGA
  114.    machines.  Perhaps i'll wait till i write a gfx converter :)
  115.  o Also add better support for the GIF standard.
  116.      at least interleaved bitmaps, a lot of GIF89a is useless
  117.  o No, can't get any faster!  (i've been trying for a few days)
  118.     (unless i get a better algorithm ...)
  119.  
  120.  -------------------------------------------------------------------------
  121.  
  122. ; history
  123. ;
  124. ; 0.0    initial
  125. ; 0.1    added 16 colour hires support
  126. ;    added a _few_ error messages
  127. ; 0.2    the decoder didn't used to stop if it ran out of blocks and it hadn't
  128. ;    Should now be able to view 16 colour gifs!
  129. ;    added a couple more messages.
  130. ; 0.3    converted '020 code to make an 00 version
  131. ; 0.4    added asynchronous file input.  WOW!  It'll load off of floppy the
  132. ;    same speed as with a HDD now!
  133.  
  134.  -------------------------------------------------------------------------
  135.  
  136.  Michael Zucchi
  137.  
  138.   9107047w@lux.levels.unisa.edu.au
  139.  
  140.   This is free, but i AM a starving programmer :) so any donations would be
  141.   most welcome!
  142.